home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 1
/
Atari Mega Archive - Volume 1.iso
/
printing
/
jacket17.arc
/
JACKET17.TXT
< prev
next >
Wrap
Text File
|
1992-04-01
|
8KB
|
188 lines
Disk Jacket v1.7
=======================
By Kenneth W. Hartlen
April 1,1992
Disk Jacket v1.7 scans a disk drive and saves the first 129
file names, sorts them by directory and filename, and prints a 3
1/2" or 5 1/4" jacket with the directory and file names listed on
it. A jacket name, current date and available disk space are also
printed on the jacket. If you regularly give your disks volume
names, Disk Jacket v1.7 can use the disk volume name for the
jacket name.
My original purpose for writing this program was to have a
file list for disks that contained source code and documents for
my university courses. By simply flipping through my disks I knew
what was on them without needing to use my computer. Now I
usually print a jacket for master disks, for ST FORMAT, Atari ST
User and STart magazine disks, etc. Now I can easily locate the
files and programs I need.
Friends expressed an interest in this utility, so I thought
I'd share it with others. I wrote the program in C and the ST
version was compiled using Lattice C v5.06 and the PC version was
compiled using Turbo C v2.0.
JACKET17.ARC
==============
The archive file JACKET17.ARC contains the required files
for using Disk Jacket v1.7 on an Atari ST or an PC compatible
computer.
JACKET.TTP The ST version of the Disk Jacket v1.7 program.
Run from GEM, NeoDesk or a CLI.
JACKET.EXE The PC version of the Disk Jacket v1.7 program,
run from MS-DOS.
JACKET.CFG The printer configuration file.
LQ2500.CFG Configuration file for Epson LQ2500 printer.
JACKET17.TXT This file.
JACKET.NIC NeoDesk v3.02 icon file containing an icon for the
ST version of the Disk Jacket v1.7 program.
If any of these files are missing, the original JACKET17.ARC
file has be tampered with. Please locate a complete JACKET17.ARC
file.
Using Disk Jacket v1.7
========================
To run the program on an ST, simply double-click the
JACKET.TTP icon in GEM or NeoDesk. Since the program is a .TTP,
you will be prompted for parameters. When run from a CLI on a ST
or from MS-DOS on a PC, you must specify the parameters. The
program usage is: jacket [-ab35ldsvu] [name]
Here is a list of legal options:
-a process drive A (*)
-b process drive B
-3 create 3.5" disk jacket (*)
-5 create 5.25" disk jacket
-l use letter quality font
-d use draft quality font (*)
-s suppress progress messages
-v use NeoDesk, TOS or MS-DOS volume name (*)
-u use user's jacket name
[name] user specified jacket name
Note: (*) indicates the default options used when
parameters are not specified.
If the -v option is used, Disk Jacket v1.7 searches for the
NEODESK.DAT file, if not found the disk TOS/DOS volume name will
be searched for, and if neither was found a the jacket name will
not have a name. If you want to use your own jacket name, use the
-u option and make sure the jacket name is the last parameter and
enclose the name in double quotes if it contains spaces.
Disk Jacket v1.7 will return one of two exit codes:
0: the program terminated normally.
-1: an illegal parameter is encountered. Or the printer is
not ready. Or the disk being scaned is empty, no
directories or files. (Note: The PC version looks for a
printer on the LPT1 port).
Note: ST users creating jackets for disks originally
formatted on an PC compatible may notice that the
volume name may appear on the jacket. This occurs if
the MS-DOS program LABEL.COM was used to give the disk
a label name. It creates a volume name but doesn't hide
it.
The files are listed in three columns on the jacket.
Directory names will separate the files as they exist on the disk
and are preceded by a backslash (\). The file names are listed
top to bottom since it is easier to see the directory structures
these way. The program searches subdirectories and ST users
should keep the 40-folder limit bug in mind and ensure a patch
has been loaded before running Disk Jacket v1.7.
After the jacket is printed it must be finished by you.
Simply cut out and fold the jacket as instructed, then tape it
together (I prefer using a UHU Stic glue stick). The jacket is
now ready to accept your disk. Since most of the time 3 1/2"
jackets will be printed, you can save paper by cutting, or
folding, single sheets into 5 1/2" by 8 1/2" sheets and single
feeding them lengthways into the printer. I have a Panasonic KX-
P1124 with front paper feed so this is convenient.
Now finding that file in a box of disks should be a little
easier and you won't have to power up your computer to do it.
The Configuration File
=========================
Since each model of printer will have different setup codes,
the Disk Jacket v1.7 program reads a configuration file called
JACKET.CFG which must contain the control codes for your printer.
If JACKET.CFG can not be found, Epson LQ2500 defaults will be
used. I've supplied a configuration file for the Epson LQ2500 and
you can easily create your own, if necessary.
The JACKET.CFG file must have the following format and can
be modified using any text editor. All values must be separated
by at least one space and be the decimal for the printer code.
Line 1: Disk Jacket Printer Configuration Codes, Epson LQ2500
Line 2: 003 027 103 015 /* 15cpi, Micron mode */
Line 3: 003 027 065 007 /* 7 60th spacing */
Line 4: 003 027 120 001 /* letter quality font */
Line 5: 001 012 /* printer form feed */
Line 6: 002 027 064 /* printer reset */
Line 1: Simply holds a comment for your purposes and is ignored
by the Disk Jacket v1.7 program.
Line 2-6: These lines contain the printer codes that your printer
recognizes. The first number is the number of values
that follow. Then up to ten control values, separated
by spaces, will be read. Again a comment for your
purposes at the end of the line is ignored.
If Disk Jacket v1.7 is not changing the cpi or lpi settings
on your printer, check to make sure your printer is set so it
will accept software control codes. If the 3 1/2" jacket is too
small or too large, make sure the the cpi is being set to 15cpi.
Disclaimer and Notes
======================
Disk Jacket v1.7 is freeware, meaning JACKET17.ARC can be
distributed freely (unmodified) and there is no cost to own a
copy. Disk Jacket v1.7 is provided AS IS. I make no warranties,
either expressed or implied, with respect to the software, its
quality, performance, or fitness. I will not be liable for
direct, indirect, or consequential damages resulting from any
defects in the software.
Having said that, I hope you find Disk Jacket v1.7 as useful
as I do.
Suggestions to improve Disk Jacket v1.7, or if any bugs are
encountered, or if you'd like to send $ (yeah, right!) can be
reported to myself:
Kenneth W. Hartlen
Box 37, Site 6, RR#3
Armdale, Nova Scotia
Canada B3L-4J3
Please send a self-addressed stamped envelop if you would
like me to reply.
I can also be reached by e-mail (until the